home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libieee1284-3 / README < prev    next >
Text File  |  2002-09-19  |  2KB  |  54 lines
  1. libieee1284 README
  2. ------------------
  3.  
  4. This library is intended to be used by applications that need to
  5. communicate with (or at least identify) devices that are attached via
  6. a parallel port.
  7.  
  8. It currently works on Linux, OpenBSD (i386 only), FreeBSD/i386,
  9. Solaris/x86, and Cygwin.
  10.  
  11. For Linux, there are some wrinkles in communicating with devices on 
  12. parallel ports:
  13.  
  14. - Applications that want to harvest IEEE 1284 Device ID information
  15.   can look in /proc for it, but it is in a different location in 2.4
  16.   kernels than it was in 2.2 kernels, and is completely absent in 2.0
  17.   kernels.
  18.  
  19. - Soon it will be in a different location again in 2.4.
  20.  
  21. - All kernels allow ioperm/inb/outb-style I/O, but it requires root
  22.   privilege.  In addition, string I/O (such as outsb) is not available
  23.   on some architectures.
  24.  
  25. - 2.4 kernels have /dev/parport[0,1,2,...] device nodes which
  26.   applications can use; applications don't need to be run as root, but
  27.   they obviously need appropriate permissions set on the device node
  28.   they want to use.
  29.  
  30. - When capabilities catch on, /dev/port will be another alternative to
  31.   ioperm that doesn't require root privilege, although it does require
  32.   RAWIO capabilities.
  33.  
  34. The aim of this library is to take all the worry about the above
  35. wrinkles from the application.  It will figure out which method is
  36. appropriate for the currently running kernel.  For instance, if the
  37. application wants to know the device ID of a device on a particular
  38. port, it will ask the library for the the device ID.  The library will
  39. then figure out if it's available via /proc (in any of the possible
  40. locations), and if not then it will try asking the device itself.  If
  41. /dev/parport0 isn't available for use, it will try ioperm; if that
  42. fails, it will try /dev/port.  And the application doesn't have to
  43. care.
  44.  
  45. The interface is set out in the header file, ieee1284.h, and in the
  46. SGML document doc/interface.xml (which can be viewed in HTML format
  47. at <http://cyberelk.net/tim/libieee1284/interface/>).  If this doesn't
  48. do something that you think it should, or it does something in a way
  49. that doesn't make sense to you, please let me know so that I can fix
  50. it.  I need feedback on the interface to know whether it is working.
  51.  
  52. --
  53. Tim Waugh <tim@cyberelk.net>
  54.